An Instance is a compute instance running on equipment in your data center and managed by MediaConnect Gateway. This Instance is an on-premises implementation of the MediaConnect service and is contained within a Gateway. Instances use Bridges to communicate between your data center and the AWS cloud. Instances are created by installing software on an on-premises server.

Instance registration is done by running a custom Linux command on the device that will be hosting the instance. You generate the command by following the instance registration process in the AWS Management Console.

Open the MediaConnect console at https://console.aws.amazon.com/mediaconnect/.

Select Gateways from the navigation pane. Select the Gateway you want to create the instance in.

On the Gateway details page, select the Instances tab. Select Register instance.

On the Register Gateway instances page, complete the following steps:

For Activation key duration, enter the number of days that the activation key will remain active. After that number of days, the key will no longer work when registering a Gateway instance.

For Number of instances, enter the number of instances that you want to register to your Gateway with the activation key.

For Instance role, choose the IAM role to associate with your external instances.

Select Generate registration command.

A Linux command will be displayed. Copy the command. You must run this command on each instance you want to register to this Gateway.

The bash portion of the script must be run as root. If the command isn't run as root, an error is returned.

After a few minutes, the instance will register to the Gateway. All instances registered to this Gateway will appear in the Instances tab.

You can deregister an instance you no longer want to use with your Gateway. By deregistering the instance, it will no longer support bridges and will not be a part of your Gateway. If you want to reuse the instance for Amazon ECS Anywhere or as another Gateway instance, you will need to follow the additional steps in Step 6 to prepare the deregistered instance for reuse.

Open the MediaConnect console at https://console.aws.amazon.com/mediaconnect/.

Select Gateways from the navigation pane. Select the Gateway that contains the instance you want to deregister.

On the Gateway details page, select the Instances tab. Select the Instance ID of the instance you want to deregister.

Select Deregister.

Confirm the deregistration of the instance by selecting Deregister instance.

Repeat these steps for any additional instances you need to deregister.

OPTIONAL: If you want to reuse the instance for Amazon ECS Anywhere or as another MediaConnect Gateway instance, you will need to complete the following steps. If not, the instance deregistration process is complete.

Make sure that the Instance state is Deregistered for the instance you want to reuse.

SSH into the instance.

Run the following commands, in order:

For more information about deleting a Gateway and its networks, visit: Removing a Gateway and its components (console)